home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / bbs_door / clasfy41.zip / CLASSIFY.DOC < prev    next >
Text File  |  1996-04-04  |  46KB  |  993 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                              CLASSIFIED ADS
  11.  
  12.                                   v4.1
  13.  
  14.                                    by
  15.  
  16.                                Al Lawrence
  17.     
  18.                              Sunrise-80  BBS
  19.                    (404) 256-9525 (33.6 USR v.everything)
  20.                    (404) 705-9104 (33.6 USR v.everything)
  21.                  (404) 256-9518 (VOICE: 9am-9:30pm EST) any day
  22.                               FIDO 1:133/6003
  23.                         (EMAIL) al_lawre@ix.netcom.com
  24.  
  25.  
  26.  
  27.                  Copyright  1992 - 1996,   Al Lawrence
  28.                           All Rights Reserved
  29.  
  30.  
  31.                           Table of Contents
  32.                           -----------------
  33.  
  34.     Overview.......................................................... 1
  35.     Installation...................................................... 2
  36.     Configuration File Description.................................... 3
  37.     Restrictions...................................................... 4
  38.     Modify an Ad...................................................... 4
  39.     Download Ads...................................................... 4
  40.     Reading Ads Offline............................................... 5
  41.     NEWS Option (CLNEWS.TXT).......................................... 5
  42.     Topics File (CLTOPICS)............................................ 6
  43.     Usage Log......................................................... 6
  44.     Category File..................................................... 7
  45.     Welcome and Goodbye Files......................................... 8
  46.     'Pay to Advertise'................................................ 9
  47.     Purging Ads, Messages............................................. 10
  48.     Database Exchange................................................. 11
  49.     Setting up a Hub to Exchange files................................ 13
  50.     Non-Standard COM Support.......................................... 15
  51.     Multi-Node Setup.................................................. 16
  52.     File Transfer Protocols (PROTOCOL.DAT)............................ 17
  53.     File Compression (COMPRESS.DAT)................................... 18
  54.     Limiting Exports by Category (CLEXPORT.DAT)....................... 19
  55.     Maintenance Program (CLMAINT)..................................... 20
  56.     PrePaid Ads....................................................... 21
  57.     Credit Card Data Collection (CLCREDIT.TXT/CLCREDIT.DAT)........... 22
  58.     PICTURE File Compression (CLEXCMPR.DAT)........................... 22
  59.     Legalities........................................................ 23
  60.     Distribution...................................................... 23
  61.     Registration...................................................... 23
  62.     Misc.............................................................. 24
  63.  
  64.                                                                        Page 1
  65.                                 OVERVIEW
  66.                                 ________
  67.  
  68.  
  69.    The CLASSIFIED Ads Door is designed to allow callers to post Classified Ads
  70.    in any of the unlimited categories you have set up. You can designate each
  71.    category to be "FREE" or "PAY". "PAY" categories give you the option of
  72.    charging businesses/individuals for posting their ads; similar to your
  73.    local newspapers.
  74.  
  75.    Optionally, electronic pictures of the products being posted, can be
  76.    attached to an Ad for the caller to access. Please note that this option
  77.    requires an additional registration.
  78.  
  79.  
  80.  
  81.    NOTE: Most errors will be logged to a file called DFRAME.ERR which is
  82.          created in the Classified Door directory.
  83.  
  84.  
  85.  
  86.                                                                        Page 2
  87.                               INSTALLATION
  88.                               ____________
  89.  
  90.  
  91.    Installation is fairly easy and straight forward. The following steps and
  92.    examples should have you up and running in a very short period of time.
  93.    It is assumed that you are familiar with setting up DOORS on your system.
  94.    To this end, only examples of the configuration file and Door batch file
  95.    (if required by your BBS software) are described.
  96.  
  97.    **** SHARE.EXE is REQUIRED! Place the word SHARE on a line by itself ****
  98.    **** in your AUTOEXEC.BAT file, anywhere after your PATH statement.  ****
  99.  
  100.       1) Create a directory to hold all CLASSIFY files
  101.  
  102.       2) Unzip CLASFYxx.ZIP into the the above directory
  103.  
  104.       3) Create a configuration file, with a name of your choice, or modify
  105.          the supplied CLASSIFY.CFG file. You can do this manually with an editor
  106.          of your choice OR you can use the configuration option in the
  107.          Classified Ads Maintnenance program (CLMAINT). The configuration file
  108.          layout/description can be found further on in this document
  109.  
  110.       4) Create a batch file or modify the CLASSIFY file supplied (if your BBS
  111.          software requires the use of a batch file to execute the door). A
  112.          description of this file follows:
  113.  
  114.             ECHO off
  115.             cd\BBS\DOORS\CLASSIFY     Location of CLASSIFY files
  116.             CLASSIFY CLASSIFY.CFG     EXE filename and CFG filename (Name
  117.                                       used in creating file in #3 above)
  118.             CD\BBS
  119.             BOARD
  120.  
  121.  
  122.        5) When running more than one node, read MULTI-NODE SETUP further on
  123.           in this document.
  124.  
  125.  
  126.        6) Unzip CLBATCH.ZIP, which contains working batch files examples for
  127.           some popular protocols.
  128.  
  129.                                                                        Page 3
  130.                         CLASSIFIED ADS CONFIGURATION FILE
  131.  
  132.    **                       Location of system file (See Below)
  133.    SUNRISE-80 BBS           Your BBS Name
  134.    Al                       Sysop's First name
  135.    Lawrence                 Sysop's Last Name
  136. |-----------------------------------------------------------------------------|
  137. | READ!     1                        CommPort  \ These 2 lines are required   |
  138. | READ!     1                        Node #    / ONLY for GTUSER.BBS          |
  139. |-----------------------------------------------------------------------------|
  140.    00000000                 Registration Number
  141.  # 2                        Keyboard timeout value in Minutes
  142.  # NONE                     Drive:\Path\Filename to contain the ASCII Bulletin
  143.                             summarizing all Ads in the database
  144.  # NONE                     Drive:\Path\Filename to contain the COLOR Bulletin
  145.                             summarizing all Ads in the database
  146.  
  147.    Y                        Y=Display the Originating BBS Name, N = Do NOT
  148.  
  149.    N                        Y =  Use European Date Format (DDMMYY)
  150.                             N =  Use Regular  Date Format (MMDDYY)
  151.  
  152.    0                        Minimum Logon Security Level required to use the new
  153.                             AD option. Zero(0) will allow access to everyone.
  154.  
  155.    0                        Minimum Logon Security Level required to use the
  156.                             DELETE option. Zero(0) will allow access to everyone
  157.  
  158.    0                        Minimum Logon Security Level required to use the
  159.                             MODIFY option. Zero(0) will allow access to everyone
  160.  
  161.    0                        Minimum Logon Security Level required to use the
  162.                             MESSAGES option. Zero(0) allows access to everyone.
  163.  
  164.    00000000                 Ads Exchange Program Registration Number
  165.  
  166.    SUN80                    Name of the EXPORT file that is generated by the
  167.                             CLEXCH program. We suggest that it be a unique name.
  168.                             DO NOT include an extension! Maximum of 6 characters
  169.  
  170.    WELCOME                  Name of the WELCOME file. CAN contain an extension.
  171.  
  172.    GOODBYE                  Name of the GOODBYE file. CAN contain an extension.
  173.  
  174.    (Any Info You Wish)      Additional information about your BBS, that will be
  175.                             displayed with each Ad posted on your BBS. We
  176.                             suggest the use of the BBS telephone # as it is
  177.                             displayed adjacent to the Originating BBS Name.
  178.                             MAXIMUM of 25 characters.
  179.  
  180.    SYSOP                    BBS name the SYSOP uses when he/she logs on. When a
  181.                             caller enters an Ad in a PAY category, a message is
  182.                             sent to THIS name to notify the Sysop about the Ad.
  183.  
  184.    Y                        Y = Allow Downloading, N = NO Downloading
  185.  
  186.  
  187.   
  188.                    CLASSIFIED ADS CONFIGURATION FILE (Cont'd)
  189.    
  190.    
  191.    N                        Y = Allow use of HiASCII characters
  192.                             N = Do NOT allow the use of HiASCII characters
  193.  
  194.    0                        Min Security level allowed to view pictures
  195.  
  196.    N                        Y = YES Import/Export Picture Files
  197.                             N = Do NOT import/Export Picture Files
  198.  
  199.    c:\classify              FULL Drive:\Pathname to the Directory where
  200.                             Picture files are located. Entry MUST end with a \
  201.  
  202.    NONE                     Line of text you wish displayed at the top of the
  203.                             screen when adding or displaying an ad. Maximum of
  204.                             76 characters and if no text is to be displayed
  205.                             you must use the word NONE
  206.  
  207.    Y                        Y = When using Option 1 on Main menu, show ALL
  208.                                 Categories
  209.                             N = Show only Categories that contain Ads
  210.  
  211.    N                        Y = Use ALIAS in lieu of the BBS Logon Name.
  212.                                 (Requires DOOR.SYS)
  213.                             N = Use normal BBS LogonName
  214.  
  215. ** = Replace with a PATH to ONE of the following:
  216.         PCBOARD.SYS    CALLINFO.BBS   DOOR.SYS   GTUSER.BBS
  217.         DORINFOx.DEF   SFDOORS.DAT
  218.  
  219.   # = Requires registration to change to a different value.
  220.  
  221.                                                                        Page 4
  222.                             RESTRICTIONS!
  223.                             -------------
  224.  
  225.    UnRegistered versions of CLASSIFIED Ads have the following restrictions:
  226.  
  227.           . Maximum of 10 Messages may be entered
  228.           . Maximum of 15 Ads may be entered
  229.           . Purge option is disabled
  230.           . WELCOME file is not recognized
  231.           . GOODBYE file is not recognized
  232.           . Keyboard timeout value remains at 2 minutes
  233.           . Bulletin will not be generated
  234.           . Unable to Export Ads, Messages and Pictures
  235.           . PAY advertising not functional
  236.           . Picture Attachment (see REGISTRATION section of this document)
  237.  
  238.  
  239.  
  240.  
  241.                            MODIFYING an AD
  242.                            ---------------
  243.  
  244.    All Ads may be modified by the caller that entered the Ad or the Sysop of
  245.    BBS on which the Ad was entered. If you, as the Sysop, try to modify an Ad
  246.    that was not entered on your BBS, the program will revert back to the Main
  247.    Menu.
  248.  
  249.  
  250.  
  251.  
  252.  
  253.                            DOWNLOADING  ADS
  254.                            ----------------
  255.  
  256.    Callers may download Ads by choosing the appropriate option from the main
  257.    menu. Downloading is OPTIONAL and is controled via an option in the
  258.    configuration file. Therefore, if you decide not to allow your callers to
  259.    download, you may set the appropriate option to "N" in the configuration
  260.    file. If you do permit downloading, you MUST define the protocols and
  261.    compression formats you will be supporting on your board. (See Compression
  262.    Formats and File Transfer Protocols in this document).
  263.  
  264.  
  265.                                                                        Page 5
  266.                         READING DOWNLOADED ADS OFFLINE
  267.                         ------------------------------
  268.  
  269.    Your callers have the ability to download the Ads database and read them
  270.    offline. They must use the reader supplied with the Classified Ads Door,
  271.    called CLREADER.
  272.  
  273.    Optionally, the caller can send a message to the Ad poster and upload the
  274.    message(s) to the Classified Ads door, on a subsequent call.
  275.  
  276.    There is an option on the Main Menu that will allow your callers to Download
  277.    the CLREADER.EXE and CLREADER.DOC files. You must ensure that both files
  278.    exist in the Classified Ads Directory. The files MUST NOT be compressed
  279.    (ZIPed, etc) as the caller will be given the option to choose one of the
  280.    compression routines you have defined for use with Classified Ads.
  281.  
  282.  
  283.  
  284.                             NEWS  OPTION
  285.                             ------------
  286.  
  287.    This Main Menu option, called NEWS, allows the Sysop to have a file
  288.    displayed to the user, that will convey some type of message relative to
  289.    the Classified Ads or a Network the Sysop belongs to or hints/tips, etc to
  290.    make the use of the Classified Ads a little easier for the user.
  291.  
  292.    The filename MUST be called CLNEWS.TXT and if the file does not exist in the
  293.    CLASSIFY directory the program will disregard that Menu option, if chosen.
  294.  
  295.                                                                        Page 6
  296.                                TOPICS File (CLTOPICS)
  297.                                ----------------------
  298.  
  299.    
  300.    
  301.    Classified Ads allows you to define an unlimited number of Categories into
  302.    which callers enter their Ads. Although this provides your callers with a
  303.    wide variety from which to choose, it takes a long time to display these
  304.    Categories on the screen (especially at lower modem speeds).
  305.  
  306.    
  307.    
  308.    To this end we have taken the approach that we will consolidate categories
  309.    into TOPICS and allow the caller to choose from a maximum of 40 TOPICS. As
  310.    each TOPIC is chosen we display ONLY those Categories that YOU have
  311.    associated with that TOPIC.
  312.  
  313.    
  314.    
  315.    If you DO NOT want to present TOPICS to your callers (yes it is optional...)
  316.    don't create the CLTOPICS file and they will be presented with the Categories
  317.    directly. OR create an ASCII file called CLTOPICS and define each topic on a
  318.    separate line, EXACTLY as you want it displayed to the caller. Each line
  319.    can have a maximum of 35 characters and a maximum of 40 TOPICS.
  320.  
  321.    
  322.    
  323.    Categories are defined in the CLASSIFY.CAT file. One of the entries for
  324.    each Category is the TOPICS number. This number corresponds to the line
  325.    number within the TOPICS file you wish to link to this Category. See
  326.    CATEGORY FILE discussion elsewhere in the documentation.
  327.  
  328.  
  329.  
  330.                              USAGE LOG
  331.                              ---------
  332.  
  333. As an option, we provide you with the ability to log every player to a text 
  334. file. IF you enter Y in the CFG file to log callers, the Door will place the
  335. caller's name as well as the ON and OFF times each time a caller selects the
  336. Door. A separate file will be created for each Node and the name of the file
  337. will be USAGEx, where x is the Node number.
  338.  
  339. You may delete these files at any time and the Door will recreate them the
  340. next time a caller enters the Door. If you do NOT want to continue logging
  341. callers, change the CFG file entry to N.
  342.  
  343.                                                                        Page 7
  344.                         CATEGORY FILE (Classify.CAT)
  345.                         ----------------------------
  346.  
  347.  
  348.    **** PLEASE NOTE: You MUST run option 12 from the CLMAINT menu EACH and 
  349.                      EVERY time you make a change to the CLASSIFY.CAT 
  350.                      (Classified Category) file.
  351.  
  352.        
  353.        Be sure to give a lot of thought to your choice of categories, since
  354.        the category position in this file is carried in each Ad record. This
  355.        means, if you set up the categories so that #2 was 'Want Ads - General'
  356.        and the caller entered an Ad under that category, the Ad would carry
  357.        category #2 as the category number. If you then decide that you want to
  358.        change the 'Want Ad - General' category to say, 'Announcements', then
  359.        the Ads carrying #2 in their record would be classified incorrectly.
  360.  
  361.                The format of the Classify.Cat file follows:
  362.  
  363.                             SS,TTTTTTTT,UU,V,WW,XX,Y,Z
  364.  
  365.                Where s = Topic number from TOPICS file or 0 if you have
  366.                          chosen not to use TOPICS
  367.                      t = Category name. Max length: 25 characters(NO COMMAS)
  368.                      u = Maximum number of days a "FREE" ad can remain active.
  369.                          Min:1 Max 365 (This value is not used with "PAY"
  370.                          categories). Each "FREE" ad carries a purge date
  371.                          calculated by adding this value to the date the Ad
  372.                          was entered.
  373.                      v = Should the program ask for COST ($$$) info. You
  374.                          would answer Y for a For Sale type category and
  375.                          an N for a WANT AD or Announcment type category.
  376.                      w = Category security level to ENTER an AD. If caller's
  377.                          logon security level is less than this security level,
  378.                          they will not be able to enter an ad in this category.
  379.                          A category security level of 0 allows anyone to enter
  380.                          an Ad.
  381.                      x = Category security level to VIEW an Ad. If caller's
  382.                          security level is less than this security level, they
  383.                          will not be able to VIEW an Ad in this category. A
  384.                          category security level of 0 allows anyone to VIEW
  385.                          an AD.
  386.                      y  = Allow Ads to be downloaded from this conference.
  387.                          Y=yes, N=no
  388.                      z = 'Pay' Category:   P = Pay   F = Free
  389.  
  390.    The Classified Ads Door will check each category entry and will report
  391.    any errors it detects. Error numbers are defined as follows:
  392.  
  393.                1 = Category Name greater than 25
  394.                2 = Days to remain active is less than 0 or greater than 365
  395.                3 = COST field contains other than a Y or N
  396.                4 = Allow downloads field contains other than a Y or N
  397.                5 = PAY field contains other than a P or F
  398.                6 = The topic number is greater than the actual number of
  399.                    topics in the CLTOPICS file OR the CLTOPICS file was
  400.                    not found in the Classify directory.
  401.  
  402.                                                                        Page 8
  403.                         WELCOME and GOODBYE Files
  404.                         -------------------------
  405.       
  406.       
  407.       
  408.       The following applies to registered versions of CLASSIFY ONLY!
  409.  
  410.       
  411.       
  412.       You can define the name of the WELCOME file in the configuration file.
  413.       If the program finds that filename, it will display that file after
  414.       the opening screen and before the main menu screens. The file must
  415.       reside in the same directory as CLASSIFY.EXE
  416.  
  417.       
  418.       
  419.       You can define the name of the GOODBYE file in the configuration file.
  420.       If the program finds that filename, it will display that file when the
  421.       caller exits the program. It will display prior to displaying the file
  422.       called ADOPT.SYS (if you have created it). The file must reside in the
  423.       same directory as CLASSIFY.EXE
  424.  
  425.  
  426.                                                                        Page 9
  427.                        "PAY-TO-ADVERTISE" Option
  428.                         ________________________
  429.  
  430.       Classified Ads can be used to charge for the placement of an
  431.       advertisement and/or allow for the ads to be placed free of charge. You
  432.       decide which on a category-by-category basis.
  433.  
  434.       You make a category a 'PAY' category by changing the appropriate entry
  435.       in the Classify.Cat file from an "F" to a "P".
  436.  
  437.       You have the option to create an ASCII file that will be displayed to
  438.       the caller, everytime they choose a particular 'PAY' category in which
  439.       to enter an ad. This file can contain any pertinant information such
  440.       as the method of payment, information required, etc. If you want the
  441.       same file to be used for ALL 'PAY' categories, then you must name the
  442.       file "PAY" (no quotes). If you want to display a unique file for some
  443.       'PAY' categories, then you must name the file  "PAYx", where x is the
  444.       line number of the corresponding entry in the ClASSIFY.CAT filer. If
  445.       the program does not find a 'PAYx" for a particular 'PAY' category, it
  446.       will then search for a "PAY" file. If neither is found it will not
  447.       display anything. We strongly suggest that you create a file for display
  448.       for all 'PAY' categories so as to ensure that the callers understand the
  449.       guidelines you have established for 'PAY' categories.
  450.  
  451.       Any ads entered into a 'PAY' category, will remain INVISIBLE to everyone
  452.       until payment is received and the Sysop makes that ad VISIBLE. You must
  453.       use the appropriate option in the Classified Ads Maintenance program
  454.       (CLMAINT) to make an ad VISIBILE. Please note that INVISIBLE ads are NOT
  455.       exported!
  456.  
  457.       The  maintenance program (CLMAINT.EXE) will display EVERY ad in the
  458.       database that is flagged as INVISIBLE. You will have the choice of
  459.       BYPASSING it, DELETING it or making it VISIBLE. Once an ad is deleted or
  460.       made VISIBLE, it can not be reversed... so BE CAREFUL!
  461.  
  462.       Registered option only.
  463.  
  464.                                                                        Page 10
  465.                            AUTOMATED PURGING
  466.                            -----------------
  467.  
  468.       When you set up the categories to be used in your version of CLASSIFIEDS,
  469.       you are asked to define the number of days the ad should remain active.
  470.       By running the CLMAINT (PURGE option) program in your nightly event
  471.       process you will ensure that the ads are deleted, automatically.
  472.  
  473.       In addition to purging expired ads, the CLMAINT Purge option will pack
  474.       the message database
  475.  
  476.       The following is all that is required to execute the purge:
  477.  
  478.                          CLMAINT CLASSIFY.CFG /EVENT
  479.                                  ^^^^^^^^^^^^
  480.                                      |
  481.                                      |------ or your congfiguration file name
  482.  
  483.           Note: This is only available in registered versions!
  484.  
  485.  
  486.   
  487.                                                                        Page 11
  488.                            DATABASE EXCHANGE
  489.                            _________________
  490.  
  491.   ** A GREAT WAY TO SHARE THE CLASSIFIED ADS DATABASE BETWEEN 2 OR MORE BBS' **
  492.      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  493.       The optional Classified Ads Database Exchange feature will allow you
  494.       to participate in the exchange of Classified Ads databases (Ads and
  495.       Messages) BBS' (Any number of BBS' can participate). The exchange
  496.       program is named CLEXCH and comes included in the CLASFYxx.ZIP file.
  497.  
  498.       CLEXCH performs three (3) major functions:
  499.  
  500.      (1) EXPORT:  Extracts all active ads and messages from the Classified
  501.                   databases. It creates files named XXXXXXrr.AXP and
  502.                   XXXXXXrr.MXP (XXXXXX is defined in the CFG file, rr is a
  503.                   random letter/number combination) and will bypass any
  504.                   ad already flagged for deletion as well as those Ads that
  505.                   were previously exported.
  506.  
  507.      (2) IMPORT:  Imports files named XXXXXXrr.AXP and XXXXXXrr.MXP and
  508.                   XXXXXXrr.MXP (XXXXXX is defined in the CFG file, rr is a
  509.                   random letter/number combination) created by the EXPORT
  510.                   option and merges all ads and messages into the Classified
  511.                   databases. It will not import any ads or messages that
  512.                   duplicates ads or messages found in the existing databases.
  513.                   Note that this option will IMPORT ALL files with an extension
  514.                   of AXP and MXP, during a single execution of the program.
  515.  
  516.      (3) IMPEXP:  This option will first IMPORT (as in (2) above) then turn
  517.                   around and EXPORT (as in (1) above) during one execcution
  518.                   of the program.
  519.  
  520.      All BBS' involved in the exchange MUST run registered versions of BOTH
  521.      Classified Ads and Classified Exchange (CLEXCH).
  522.  
  523.      It is critical that ALL participants in the exchange use the SAME
  524.      Category file. Failure to do so will result in ads meant for a certain
  525.      category on one system, showing up in a category totally unrelated on
  526.      another system.
  527.  
  528.  
  529.  
  530.       N O T E:  To EXCLUDE certain categories from being exported see
  531.                 "Limiting Export by Category" elsewhere in this document
  532.  
  533.  
  534.  
  535.  
  536.                             (Continued on Next Page)
  537.  
  538.  
  539.                                                                        Page 12
  540.                         DATABASE EXCHANGE (Continued)
  541.  
  542.  
  543.      To run the Exchange you do the following:
  544.  
  545.     ************************************************************************
  546.     * >>>>> If you are acting as a HUB you MUST signal CLEXCH.EXE by using *
  547.     *       HUBEXPORT, HUBIMPORT or HUBIMPEXP in lieu of EXPORT, IMPORT or *
  548.     *       IMPEXP. If you fail to do this you will not be able to export  *
  549.     *       newly imported Ads/Messages.                                   *
  550.     ************************************************************************
  551.  
  552.      EXPORT:  a) Change to the directory containing your CLASSIFY.DAT file
  553.               b) Issue this command:  CLEXCH EXPORT CLASSIFY.CFG
  554.                  If you use a different name for your Config file, then
  555.                  substitute that name for CLASSIFY.CFG
  556.               c) Send (transmit) ALL *.AXP and *.MXP files to those involved
  557.                  in the exchange or to the HUB.
  558.               d) Delete ALL .AXP and .MXP files
  559.  
  560.      IMPORT:  a) Change to the directory containing your CLASSIFY.DAT file
  561.               b) Copy the *.AXP and *.MXP files that were sent to you by the
  562.                  BBS you are exchanging with, to the directory used
  563.                  in item (a) above.
  564.               c) Issue the command:   CLEXCH IMPORT CLASSIFY.CFG
  565.                  If you use a different name for your Config file, then
  566.                  substitute that name for CLASSIFY.CFG
  567.               d) Delete ALL *.AXP and *.MXP files
  568.  
  569.      IMPEXP:  a) Change to the directory containing your CLASSIFY.DAT file
  570.               b) Copy the *.AXP and *.MXP files that were sent to you by the
  571.                  BBS you are exchanging with, to the directory used
  572.                  in item (a) above.
  573.               c) Issue the command:   CLEXCH IMPEXP CLASSIFY.CFG
  574.                  If you use a different name for your Config file, then
  575.                  substitute that name for CLASSIFY.CFG
  576.               d) Send (transmit) ALL *.AXP and *.MXP files to those involved
  577.                  in the exchange or to the HUB.
  578.  
  579.  
  580.    NOTE: If you wish to EXPORT ALL Ads in the database regardless of whether
  581.          they have been previously exported, you can use the /ALL switch on
  582.          the CLEXCH command line. It can only be used with HUBIMPORT,
  583.          HUBEXPORT or HUBIMPEXP and MUST be the last entry on the command line.
  584.  
  585.    NOTE: When registering CLEXCH, you MUST use the EXACT SAME Sysop Name
  586.          AND BBS NAME as used for CLASSIFIED ADS!!!!!!!!!!!!!!!!!!!!!!!!!
  587.  
  588.    NOTE: All IMPORT and EXPORT transactions are now recorded in a
  589.          file called CLEXCH.LOG. If the file exists it will append
  590.          the information, if not it will create the file and add
  591.          the information. Thus you are free to delete it at any time.
  592.  
  593.  
  594.                                                                        Page 13
  595.          HOW TO SETUP AS A HUB AND DO CLASSIFIED ADS EXCHANGES
  596.          -----------------------------------------------------
  597.  
  598. Below, is a fully working batch file complete with comments, for the group
  599. hub. There are a few very important things to remember in running the
  600. Classified Ads as a hub.
  601.  
  602. FIRST, make sure all your nodes have the same categories or mass confusion
  603. will result. SECOND, it is highly advisable that you and your nodes use a
  604. unique name (representative of your board) instead of the generic
  605. "Classify.exp", for example Sun.exp would be the name for Sunrise BBS.
  606. THIRD, this batch file (Exchange.bat) is best run during your event each
  607. night, rather than each time the door is executed, especially if you are
  608. connected to boards that are long distance. The commands for your nightly
  609. event batch file would be:
  610.  
  611. CD\CLASSIFY
  612.    CLPURGE CLASSIFY.CFG
  613.    CALL EXCHANGE.BAT
  614.    DEL CLASSIFY.EXP
  615. CD\
  616.  
  617. Exchange.bat would be located in your classified directory and would be the
  618. batch file listed below. You may feel free to remove the comments and use
  619. the batch file below after modification for your system drive/path/name
  620. specifications.
  621.  
  622.  
  623.  
  624.  
  625.  
  626.                      (Continued on Next Page)
  627.  
  628.  
  629.                                                                        Page 14
  630.  
  631.                        HUB SETUP (Continued)
  632.  
  633.  
  634. _______________________________________________________________________________
  635. BATCH FILE EXAMPLE FOR THE HUB USING THE CLASSIFIED ADS EXCHANGE PROGRAM
  636.  
  637.  
  638.  
  639. @echo off
  640. del I:\db\files\classify.exp
  641.     ^  ^^ ^^^^^
  642. Comment: Above would be the drive/path to your inbound/outbound files directory.
  643.          This command will delete your previous night's export. NOTE: DO NOT
  644.          use this command the first night you start the import/export with
  645.          other boards.
  646.  
  647. cd\db\files
  648.    copy *.exp I:\ra\doors\classify
  649.         ^^^^^
  650.    del *.exp
  651.        ^^^^^
  652.  
  653. Comment: Copy all exported files sent to you into your classified directory,
  654.          then delete all the exported files. FAILURE to use a unique .exp
  655.          name will result in files over writing and only the last .exp file
  656.          copied will be imported into your database.
  657.  
  658. cd\ra\doors\classify
  659.    clexch IMPEXP classify.cfg
  660.                  ^^^^^^^^^^^^
  661.    copy classify.exp i:\db\files
  662.         ^^^^^^^^^^^^    ^^ ^^^^^
  663.  
  664. Comment: Perform the import/export (IMPEXP) then copy the resulting export file
  665.          from your classify directory to your outbound files directory.
  666.  
  667. cd\db
  668.    dbutil i send 1:114/203 i:\db\files\classify.exp
  669.    ^^^^^^
  670.  
  671. Comment: Send the export file to the other boards. Note above that the command
  672.          used is for D'Bridge...you may substitute the proper command and
  673.          outbound files directory for your front end mailer. You will need to
  674.          do an export for every BBS connected to you.
  675.  
  676.     __________________________________________________________
  677.    | This example provided to you courtesy of: Window In Time |
  678.    |                                           1:114/203      |
  679.    |                                           602-253-1946   |
  680.    |                                                          |
  681.    |  Feel free to contact the Sysop of Window In Time!!!!    |
  682.    |__________________________________________________________|
  683.  
  684.  
  685.  
  686.  
  687.                                                                        Page 15
  688.                         NON-STANDARD COM SUPPORT
  689.                         ________________________
  690.  
  691.       Support for COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  692.       COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  693.       number after the configuration filename. Let's assume your Door is
  694.       called FOOBAR and you want to use COM1 and IRQ5. The command line
  695.       passed to your Door would be:
  696.  
  697.                             FOOBAR FOOBAR.CFG /5
  698.  
  699.       The /5 tells FOOBAR to use IRQ5 rather than the standard IRQ4 that is
  700.       normally used with COM1. No /x parameter is needed for the standard
  701.       IRQ's.
  702.  
  703.       As an alternative, you may use an environmental variable on the command
  704.       line. To use the variable (following the example above), place a
  705.       SET IRQ=5 in the batch file used to bring up your BBS (you would need a
  706.       different IRQ number for each node). The command line would now look
  707.       like this:
  708.  
  709.                           FOOBAR FOOBAR.CFG /%IRQ%
  710.  
  711.       This, in combination with the use of the environmental variables
  712.       described in the MULTI-NODE SETUP section will allow you to use one
  713.       batch file and one config file to run this door on all nodes.
  714.  
  715.  
  716.  
  717.   
  718.                                                                        Page 16
  719.                            MULTI-NODE SETUP
  720.                            ________________
  721.  
  722.       All Sunrise Doors are Multi-Node capable. Each node must have the
  723.       ability to access a configuration file which will have its own system
  724.       file (DORINFOx.DEF, PCBOARD.SYS, DOOR.SYS, etc) defined on the first
  725.       line. There are 2 ways to accomplish this:
  726.  
  727.       (1) Create a separate configuration file for each node. The only
  728.           difference between each file would be the location of the system
  729.           file for that particular node. For example, on my system there are 2
  730.           nodes and the first line of the config files would look like this:
  731.  
  732.                         NODE1:  H:\PCB1\DOOR.SYS
  733.                         NODE2:  H:\PCB2\DOOR.SYS
  734.  
  735.           Thus, if you have a 4 node BBS, you will need 4 configuration files.
  736.  
  737.       (2) Use ONE configuration file for ALL nodes. This Door will recognize
  738.           the following PCBoard/Wildcat environmental variables:
  739.  
  740.                  PCBDIR    (Directory containing the System file)
  741.                  PCBDRIVE  (Drive containing the System file)
  742.                  WCNODEID  (Active Node Number)
  743.  
  744.           Thus, the first line of the SINGLE configuration file, for this Door
  745.           would look like this:
  746.  
  747.                         %PCBDRIVE%%PCBDIR%\DOOR.SYS
  748.                         c:\wc30\wcwork\node%wcnodeid%\door.sys
  749.  
  750.       NOTE: This option, as described, assumes that you are running PCB or
  751.             Wildcat software. The environmental variables are automatically
  752.             created by the software for each node.
  753.  
  754.             HOWEVER, if you are running other BBS software you should be able
  755.             to set the variables EXACTLY as described below, for EACH node
  756.             (more than likely in each batch file you use to bring up EACH node):
  757.  
  758.                             PCBDRIVE=C:
  759.                             ^^^^^^^^^
  760.                             PCBDIR=\NODE2
  761.                             ^^^^^^^^
  762.  
  763.             Info with a carat (^) under it, MUST be typed as is. The rest
  764.             depends on your naming conventions.
  765.  
  766.             This, in combination with the use of the optional environmental
  767.             variable described in the NON-STANDARD COM SUPPORT section, will
  768.             allow you to use one batch file and one config file to run this
  769.             door on all nodes.
  770.  
  771.  
  772.  
  773.                                                                        Page 17
  774.                    UPLOAD/DOWNLOAD FILE TRANSFER PROTOCOLS
  775.                    ---------------------------------------
  776.  
  777.       Classified Ads externalizes all file transfer protocols used for Uploading
  778.       and Downloading of the Classified Ads. This allows the Sysop to define the
  779.       file transfer protocols they wish to support.
  780.  
  781.       A file called PROTOCOL.DAT is supplied with protocols already defined,
  782.       which you may alter at any time. Each entry in the PROTOCOL.DAT file
  783.       consists of the description that will be displayed to the caller on the
  784.       Protocol Menu and the 'high level' name of the protocol's batch files.
  785.  
  786.                Example:  ZModem   Upload or Download, ZPROT
  787.  
  788.       The information to the left of the comma is the description. Classified
  789.       requires that you have 2 batch files in the Classified directory to handle
  790.       the uploading and downloading. In the above example ZPROT is the 'high
  791.       level' portion of the 2 batch file names required for ZMODEM. Your
  792.       Classified directory should contain ZPROTR.BAT (the R is for uploading)
  793.       and ZPROTS.BAT (the S is for downloading). The R and S suffixes MUST be
  794.       present as that is what Classified Ads will be looking for in the
  795.       Classified Ad directory!
  796.  
  797.       Each protocol batch file MUST contain 2 batch file variables as follows:
  798.  
  799.       %1 = Classified will use this variable to substitute the current ComPort
  800.       %2 = Classified will use this variable to substitute the file name
  801.  
  802.       IMPORTANT! Place the variable (%1 and %2) ONLY in the EXACT location that
  803.                  your protocol requires them, in the protocol command line. Do
  804.                  NOT supply the ComPort or FileName, JUST the %1 and %2
  805.                  variables themselves (%1 and %2)!
  806.  
  807.       See example batch files supplied with the Classified. They are the ones
  808.       being used on the Sunrise-80 BBS.
  809.  
  810.                              *** PLEASE NOTE ***
  811.  
  812.       There may come a time when you will need to supply information to the
  813.       protocol you are using, based on the node it will be used on. You can
  814.       accomplish this by supplying a node-specific PROTOCOL file. Everything
  815.       described above stays the same except that you will name the file
  816.       PROTOCOL.x (where x is the node number). For example, to use a special
  817.       set of protocols (or batch files) on node number 5, modify a copy of
  818.       PROTOCOL.DAT and name it PROTOCOL.5. CLASSIFY will use PROTOCOL.5 when
  819.       someone logs on node 5 and will use PROTOCOL.DAT for ALL OTHERS. You do
  820.       not have to create node-specific PROTOCOL files for all nodes.. just the
  821.       node(s) that are different.
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.                                                                        Page 18
  834.  
  835.                     FILE COMPRESSION (COMPRESS.DAT)
  836.                     -------------------------------
  837.  
  838.    When a caller chooses to download a file of any kind, from Classified Ads,
  839.    they are presented with a list of compression types from which to choose.
  840.  
  841.    A file called COMPRESS.DAT is supplied with several types already defined.
  842.    You are free to alter the file to reflect the ones you support. Each entry
  843.    in the COMPRESS.DAT file consists of the description that will be displayed
  844.    to the caller on the Compression Menu, the name of the compression file
  845.    name and the command used to add files to the archive.
  846.  
  847.      EXAMPLE:
  848.                  PKZip  v1.10,PKZIP -a
  849.                  ARJ    v2.3,ARJ a
  850.  
  851.  
  852.    Please note that everything to the left of the comma is part of the
  853.    description for that compression type and may be modified to your liking.
  854.  
  855.  
  856.                                                                        Page 19
  857.  
  858.                      LIMITING EXPORTS BY CATEGORY
  859.                      ----------------------------
  860.  
  861.    By default the CLEXCH (Classified Exchange) program will export ads in ALL
  862.    categories. If you wish to limit the categories that will be exported,
  863.    create an ASCII file and call it CLEXPORT.CAT and enter the category
  864.    number(s) you DO NOT want to export, ONE to a line. The category number is
  865.    the line position of the category as it exists in the CLASSIFY.CAT file.
  866.  
  867.    For example, if the CLASSIFY.CAT file contained:
  868.  
  869.              Local For Sale
  870.              National For Sale
  871.              Local Announcements
  872.              National Announcements
  873.  
  874.    and you did NOT want to export local categories, you would create
  875.    CLEXPORT.CAT and input the following in the file:
  876.  
  877.    1
  878.    3
  879.  
  880.    Those 2 entries in the CLEXPORT.CAT would tell CLEXCH to NOT export the
  881.    "Local For Sale" and "Local Announcements" categories.
  882.  
  883.  
  884.                                                                        Page 20
  885.  
  886.                     MAINTENANCE PROGRAM (CLMAINT)
  887.                     -----------------------------
  888.  
  889.    The Classified Ads Maintenance program, CLMAINT.EXE, is a menu driven
  890.    program used to perform the following functions:
  891.  
  892.    (1) Maintain the PREPAID Ads file
  893.        . Add/view/delete prepaid ads entries in the PREPAID file
  894.  
  895.    (2) Database PURGE
  896.        .Will purge Ads, Messages and Prepaid Ads entries from their
  897.         respective files if they are marked for deletion.
  898.  
  899.    (3) View/maintain the Invisible Paid ads
  900.        .When an ad is entered into a PAID category, it is made invisible
  901.         (not displayable) until you manually make it visible. This option
  902.         allows you to do this or you can view and/or delete it
  903.  
  904.    (4) Setup the Classified Ads configuraiton file
  905.        .Use this option to setup or modify a configuration file.
  906.  
  907.    (5) Reset the EXPORT flag of ALL Ads in the database
  908.        .Use this option to force ALL ads in the Ads database to be marked for
  909.         Export the next time you run CLEXCH.
  910.  
  911.    (6) Reset the EXPORT flag of ALL Messages in the database
  912.        .Use this option to force ALL messages in the Message database to be
  913.         marked for Export the next time you run CLEXCH.
  914.  
  915.    (7) Create/Update the CLassify.CNT file. This fiel keeps track of the 
  916.        number of Ads in each category.
  917.  
  918.    (8) Transfer Ads from one Category to another (must run option 12 as well)
  919.  
  920.  
  921.    Execution examples:
  922.  
  923.       CLMAINT CLASSIFY.CFG               <===== Manual
  924.  
  925.              or
  926.  
  927.       CLMAINT CLASSIFY.CFG /EVENT        <===== Auto purge from an Event
  928.  
  929.                                                                        Page 21
  930.  
  931.                            PRE-PAID ADS
  932.                            ------------
  933.  
  934.    This option will allow you to accept payment for ads in advance. Using the
  935.    PREPAID ads option in the maintenance program (CLMAINT.EXE), you can add,
  936.    view or delete entries in the PREPAID file. The PREPAID file will contain
  937.    the name of the caller, the Ad display time (Week/Month/Quarter/Year) and
  938.    the number of ads they have prepaid for that type of Ad.
  939.  
  940.    You must have a separate entry for each display time type for each caller.
  941.    For example, a caller named Joe Door can prepay for 2 Monthly Ads and 3
  942.    Weekly Ads. In this case you would need 2 Joe Door entries in the PREPAID
  943.    file, one for the WEEKLY Ads and 1 for the Monthly Ads.
  944.  
  945.    When the caller enters an Ad in a PAY category, Classify asks what length
  946.    of time the Ad should run. If the program finds a match in the PREPAID file,
  947.    (on caller name and display time) it will make the Ad VISIBLE, IMMEDIATELY
  948.    and decrement the number of Pre-Paid Ads by 1.
  949.  
  950.    When the Purge option in CLMAINT is run (Manually or as an Event) entries
  951.    in the PREPAID file with a zero in the number of ads filed, will be deleted.
  952.  
  953.  
  954.    
  955.                                                                        Page 22
  956.                                                                        
  957.                     CREDIT CARD DATA COLLECTION                                                                       
  958.                     ---------------------------                                                                       
  959.                     
  960.  
  961.    Classified Ads can optionally accept credit card information from those 
  962.    callers placing "PAID" Ads. This option will be in effect IF the program 
  963.    finds a file named CLCREDIT.TXT in the Classified directory. This file can 
  964.    contain a maximum of 20 questions that you wish the caller to answer 
  965.    relative to their credit card. The maximum length of any line in the file is
  966.    38 characters and the number of characters the caller may respond with is 40. 
  967.    You may format each line any way you wish as long as the above criteria is 
  968.    adhered to. 
  969.    
  970.    A file named CLCREDIT.DAT will be created and will contain all information 
  971.    entered by the caller, along with other pertinent information about the Ad 
  972.    posted. The information from each caller will be APPENDED to the file and 
  973.    it is the Sysop's responsibility to delete that file when they have captured 
  974.    the information. A sample CLCREDIT.TXT file is included in the archive. 
  975.    Should you NOT want to accept credit cards then YOU must either delete the 
  976.    CLCREDIT.TXT file or rename to some other name for future use.
  977.    
  978.    
  979.    
  980.    
  981.                      PICTURE FILE COMPRESSION (CLEXCMPR.DAT)
  982.                      ---------------------------------------
  983.  
  984.  
  985.     To facilitate the Exchange of PICTURE files we must compress them all into 
  986.     ONE file. To this end we use a file called CLEXCMPR.DAT to define the names 
  987.     of the BATCH files that will be used. The CLEXCMPRS.DAT file supplied 
  988.     contains the names of 2 batch files called ZIPIT.BAT and UNZIPIT.BAT. As 
  989.     the names imply, one is used to ZIP up the PICTURE files and the other is 
  990.     used to UNZIP the PICTURE files.
  991.  
  992.     The 2 batch files can be changed to reflect another type of compression 
  993.